home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / sat_eventtostr.z / sat_eventtostr
Text File  |  1998-10-20  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSAAAATTTT____EEEEVVVVEEEENNNNTTTTTTTTOOOOSSSSTTTTRRRR((((3333LLLL))))                                          SSSSAAAATTTT____EEEEVVVVEEEENNNNTTTTTTTTOOOOSSSSTTTTRRRR((((3333LLLL))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sat_eventtostr, sat_strtoevent - convert an audit event index to/from an
  10.      audit event string
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssaaaatttt....hhhh>>>>
  14.  
  15.      cccchhhhaaaarrrr **** ssssaaaatttt____eeeevvvveeeennnnttttttttoooossssttttrrrr ((((eeeevvvveeeennnntttt))))
  16.      iiiinnnntttt eeeevvvveeeennnntttt;;;;
  17.  
  18.      iiiinnnntttt ssssaaaatttt____ssssttttrrrrttttooooeeeevvvveeeennnntttt ((((eeeevvvvssssttttrrrr))))
  19.      cccchhhhaaaarrrr ****eeeevvvvssssttttrrrr;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _s_a_t__e_v_e_n_t_t_o_s_t_r returns a human-readable string which represents the audit
  23.      event passed to it in _e_v_e_n_t.  The value returned points to a static
  24.      character array.
  25.  
  26.      _e_v_e_n_t must be a positive integer less than SSSSAAAATTTT____NNNNTTTTYYYYPPPPEEEESSSS (defined in
  27.      <<<<ssssyyyyssss////ssssaaaatttt....hhhh>>>>).
  28.  
  29.      _s_a_t__s_t_r_t_o_e_v_e_n_t returns a machine-readable event index which represents
  30.      the string passed to it in _e_v_s_t_r.
  31.  
  32.      The string returned by _s_a_t__e_v_e_n_t_t_o_s_t_r and passed to _s_a_t__s_t_r_t_o_e_v_e_n_t is a
  33.      member of the set of known event names. For a complete list of known
  34.      event names, run the command:
  35.  
  36.           sat_select -h
  37.  
  38. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  39.      sat_reduce(1m)
  40.      sat_select(1m)
  41.      sat_summarize(1m)
  42.  
  43. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  44.      _s_a_t__e_v_e_n_t_t_o_s_t_r returns _u_n_k_n_o_w_n _e_v_e_n_t #%_d if _e_v_e_n_t is not a positive
  45.      integer less than SSSSAAAATTTT____NNNNTTTTYYYYPPPPEEEESSSS.  _s_a_t__s_t_r_t_o_e_v_e_n_t returns ----1111 if _e_v_s_t_r is NULL
  46.      or points to an audit event of unrecognized type.
  47.  
  48. NNNNOOOOTTTTEEEESSSS
  49.      If this function is used in a program, then the library lllliiiibbbbmmmmllllssss must be
  50.      linked at compile time.  For example the following command will perform
  51.      this link:
  52.  
  53.           cc  -DTRUSTEDIRIX  -DLABELLEDSOCKETS  _p_r_o_g_r_a_m_n_a_m_e.c  -lmls
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.